home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglnewlist.z / fglnewlist
Text File  |  1998-10-20  |  11KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt,,,, ffffggggllllEEEEnnnnddddLLLLiiiisssstttt - create or replace a display list
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt( INTEGER*4 _l_i_s_t,
  14.                             INTEGER*4 _m_o_d_e )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _l_i_s_t  Specifies the display-list name.
  19.  
  20.      _m_o_d_e  Specifies the compilation mode, which can be GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE or
  21.            GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE____AAAANNNNDDDD____EEEEXXXXEEEECCCCUUUUTTTTEEEE.
  22.  
  23. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  24.      SUBROUTINE ffffggggllllEEEEnnnnddddLLLLiiiisssstttt( )
  25.  
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      Display lists are groups of GL commands that have been stored for
  29.      subsequent execution.  Display lists are created with ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt.  All
  30.      subsequent commands are placed in the display list, in the order issued,
  31.      until ffffggggllllEEEEnnnnddddLLLLiiiisssstttt is called.
  32.  
  33.      ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt has two arguments.  The first argument, _l_i_s_t, is a positive
  34.      integer that becomes the unique name for the display list.  Names can be
  35.      created and reserved with ffffggggllllGGGGeeeennnnLLLLiiiissssttttssss and tested for uniqueness with
  36.      ffffggggllllIIIIssssLLLLiiiisssstttt.  The second argument, _m_o_d_e, is a symbolic constant that can
  37.      assume one of two values:
  38.  
  39.      GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE                    Commands are merely compiled.
  40.  
  41.      GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE____AAAANNNNDDDD____EEEEXXXXEEEECCCCUUUUTTTTEEEE        Commands are executed as they are compiled
  42.                                    into the display list.
  43.  
  44.      Certain commands are not compiled into the display list but are executed
  45.      immediately, regardless of the display-list mode.  These commands are
  46.      ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllDDDDeeeelllleeeetttteeeeLLLLiiiissssttttssss, ffffggggllllDDDDiiiissssaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee,
  47.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee, ffffggggllllFFFFeeeeeeeeddddbbbbaaaacccckkkkBBBBuuuuffffffffeeeerrrr, ffffggggllllFFFFiiiinnnniiiisssshhhh,
  48.      ffffggggllllFFFFlllluuuusssshhhh, ffffggggllllGGGGeeeennnnLLLLiiiissssttttssss, ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr, ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss,
  49.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd, ffffggggllllIIIIssssLLLLiiiisssstttt, ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb,
  50.      ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ffffggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb, ffffggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ffffggggllllRRRReeeennnnddddeeeerrrrMMMMooooddddeeee,
  51.      ffffggggllllSSSSeeeelllleeeeccccttttBBBBuuuuffffffffeeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr, and all of the
  52.      ffffggggllllGGGGeeeetttt commands.
  53.  
  54.      Similarly, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD and ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD are executed immediately and
  55.      not compiled into the display list when their first argument is
  56.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD or GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, respectively.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      When ffffggggllllEEEEnnnnddddLLLLiiiisssstttt is encountered, the display-list definition is completed
  75.      by associating the list with the unique name _l_i_s_t (specified in the
  76.      ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt command). If a display list with name _l_i_s_t already exists, it
  77.      is replaced only when ffffggggllllEEEEnnnnddddLLLLiiiisssstttt is called.
  78.  
  79. NNNNOOOOTTTTEEEESSSS
  80.      ffffggggllllCCCCaaaallllllllLLLLiiiisssstttt and ffffggggllllCCCCaaaallllllllLLLLiiiissssttttssss can be entered into display lists.  Commands
  81.      in the display list or lists executed by ffffggggllllCCCCaaaallllllllLLLLiiiisssstttt or ffffggggllllCCCCaaaallllllllLLLLiiiissssttttssss are
  82.      not included in the display list being created, even if the list creation
  83.      mode is GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE____AAAANNNNDDDD____EEEEXXXXEEEECCCCUUUUTTTTEEEE.
  84.  
  85.      A display list is just a group of commands and arguments, so errors
  86.      generated by commands in a display list must be generated when the list
  87.      is executed. If the list is created in GGGGLLLL____CCCCOOOOMMMMPPPPIIIILLLLEEEE mode, errors are not
  88.      generated until the list is executed.
  89.  
  90. EEEERRRRRRRROOOORRRRSSSS
  91.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_i_s_t is 0.
  92.  
  93.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  94.  
  95.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllEEEEnnnnddddLLLLiiiisssstttt is called without a
  96.      preceding ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt, or if ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt is called while a display list is
  97.      being defined.
  98.  
  99.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllNNNNeeeewwwwLLLLiiiisssstttt or ffffggggllllEEEEnnnnddddLLLLiiiisssstttt is executed
  100.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  101.      ffffggggllllEEEEnnnndddd.
  102.  
  103.      GGGGLLLL____OOOOUUUUTTTT____OOOOFFFF____MMMMEEEEMMMMOOOORRRRYYYY is generated if there is insufficient memory to compile
  104.      the display list. If the GL version is 1.1 or greater, no change is made
  105.      to the previous contents of the display list, if any, and no other change
  106.      is made to the GL state. (It is as if no attempt had been made to create
  107.      the new display list.)
  108.  
  109. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  110.      ffffggggllllIIIIssssLLLLiiiisssstttt
  111.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIISSSSTTTT____IIIINNNNDDDDEEEEXXXX
  112.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIISSSSTTTT____MMMMOOOODDDDEEEE
  113.  
  114.  
  115. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  116.      ffffggggllllCCCCaaaallllllllLLLLiiiisssstttt, ffffggggllllCCCCaaaallllllllLLLLiiiissssttttssss, ffffggggllllDDDDeeeelllleeeetttteeeeLLLLiiiissssttttssss, ffffggggllllGGGGeeeennnnLLLLiiiissssttttssss
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.